home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / dots151.zip / DOTS.DOC < prev    next >
Text File  |  1990-10-10  |  9KB  |  255 lines
  1. NAME
  2.     dots
  3.  
  4. SYNOPSIS
  5.     dots  [file1 file2...] [options]
  6.  
  7. DESCRIPTION
  8.     Dots accepts a file of triples of numbers, the X, Y, and Z
  9.     coordinates of points, and displays a perspective projection of
  10.     them as points or connected by lines.  The user can then alter his
  11.     viewpoint with the cursor keys, and the display is redrawn.
  12.  
  13.     More than one input file can be specified.  All the data will
  14.     be read before scaling parameters are calculated.  The plot
  15.     will be "broken" at the end of each file.  That is, there will
  16.     be no line connecting the last point of the first file with the
  17.     first point of the second file.
  18.  
  19.     The default volume displayed ranges from the minimum to the maximum
  20.     coordinate value present along each axis among the data points. 
  21.     The default viewing transformation is a perspective projection.
  22.  
  23.     When executed with the single argument ? or when an error is made in
  24.     the arguments, a usage example is printed.
  25.  
  26.     Key commands available:
  27.  
  28. Cursor keys move observer higher, lower, around to left, or around to right.
  29. +        enlarge cursor key steps by a factor of 4
  30. -        shrink cursor key steps by a factor of 4
  31. pg up    move viewpoint closer
  32. pg dn    move viewpoint further away
  33. home     enlarge display (factor 1.414)
  34. end      shrink display (factor .707)
  35. q        exit program
  36. ?        print this help menu
  37.  
  38.     Using the photographic analogy, <home> and <end> correspond to
  39.     changing the focal length of the lens, while <pg up> and <pg dn>
  40.     correspond to moving the photographer.  The camera always points
  41.     toward the "view reference point", which is the center of the box
  42.     enclosing the data.
  43.  
  44.     With parallel perspective, the distance from the viewpoint to the
  45.     displayed data would make no difference in the display, so the <pg
  46.     up> and <pg dn> keys instead have the same effect as the <home> and
  47.     <end>, respectively.
  48.  
  49. VERSIONS
  50.     DOTS is available in several versions.  When necessary for
  51.     configuration control, these versions are given different file
  52.     names (see FILES section below).  It is suggested that the
  53.     "normal" version for a given computer be renamed DOTS for
  54.     simplicity.  Any version of DOTS can be executed with a
  55.     question mark as the only parameter:
  56.  
  57.         DOTS ?
  58.  
  59.     It will then print a help screen which includes the hardware it
  60.     supports, and exit immediately.  In addition, DOTS tests that the
  61.     hardware it needs is present before using it (except for the hard
  62.     copy versions).
  63.  
  64.     For the display version of DOTS, you will need a device driver in the
  65.     form of a .BGI (for Borland Graphics Interface) appropriate for
  66.     your hardware.  If you have one of the following standard graphics
  67.     cards, you can use one of those supplied by Borland:
  68.  
  69.         CGA
  70.         MCGA
  71.         EGA
  72.         ATT400
  73.         VGA
  74.         PC3270
  75.         IBM8514
  76.         Hercules mono
  77.  
  78.     If so, you need only put the .BGI file where DOTS can find it.  DOTS
  79.     will look in the directories listed in the environment variable
  80.     BGIPATH if it is set, otherwise it will look in the directories
  81.     indicated by PATH.  For example:
  82.  
  83.         C>set bgipath=C:\MY\BGIFILES;C:\TC\BGI
  84.         C>dots mydata
  85.  
  86.     If you put both DOTS.EXE and the required .BGI file into one of the
  87.     directories in your PATH, you will not need to add anything to
  88.     your environment.
  89.  
  90.     If you want to select a particular graphics mode, you may set the
  91.     environment variable GRAPHMODE to one of the numeric constants of
  92.     "graphics_modes" enumeration type as defined by Borland.  The
  93.     constants are as follows:
  94.  
  95.                mode           value
  96.     ------------------    -----
  97.     CGA    320*200    C0    0
  98.     CGA    320*200    C1    1
  99.     CGA    320*200    C2    2
  100.     CGA    320*200    C3    3
  101.     CGA    640*200     4
  102.  
  103.     MCGA    320*200 C0    0
  104.     MCGA    320*200 C1    1
  105.     MCGA    320*200 C2    2
  106.     MCGA    320*200 C3    3
  107.     MCGA    640*200        4
  108.     MCGA    640*480        5
  109.  
  110.     EGA    640*200        0
  111.     EGA    640*350        1
  112.     EGAMONO    640*350        3
  113.  
  114.     HERC    720*348        0
  115.  
  116.     ATT400    320*200    C0    0
  117.     ATT400    320*200    C1    1
  118.     ATT400    320*200    C2    2
  119.     ATT400    320*200    C3    3
  120.     ATT400    640*200        4
  121.     ATT400    640*400        5
  122.  
  123.     VGA    640*200        0
  124.     VGA    640*350        1
  125.     VGA    640*480        2
  126.  
  127.     PC3270    720*350        0
  128.  
  129.     IBM8514    640*480        0
  130.         1024*768    0
  131.  
  132.     ...where C0, C1, C2, and C3 refer to the four palettes on the CGA
  133.     and compatible systems.
  134.  
  135.     If you have nonstandard video hardware, you will have to obtain or
  136.     write a .BGI file.  In that case, set the environment variable
  137.     BGIDRIVER to the name of the file.  For example, if your driver
  138.     is named SGA.BGI, you would set the environment variable as
  139.     follows:
  140.  
  141.         C>set bgidriver=SGA
  142.  
  143.     No hardware autodetection of nonstandard video cards is supported.
  144.  
  145. OPTIONS
  146.    &<name>    (hard copy versions only) Device driver switches are 
  147.         in the configuration file <name>.  See "DEVICE DRIVER 
  148.         CONFIGURATION FILES" below.
  149.    -a [step [start]] automatic abscissas 
  150.    -b       break graph after each label
  151.    -f       omit frame around plot 
  152.    -m  n1 n2 n3...
  153.         The numeric arguments are linestyles for successive
  154.         line segments (see switch -b).  Each positive argument
  155.         is a number of up to three digits WCS, where
  156.             W is the linewidth (0-9, with 0 giving width 1), 
  157.             C is the color (with 0 being brightest), and 
  158.             S is linestyle (1-5, 1 for solid, 2 for dashed,
  159.                 3 for dotted, etc.) 
  160.         If an argument is zero, the data points are plotted as
  161.         dots not connected by lines.  Similarly, a negative
  162.         argument -CS generates a marker:
  163.             C is the color
  164.             S is the marker style (dot, box, cross, etc.)
  165.  
  166.    -o  ox oy oz       
  167.                 specify initial observer location (especially useful
  168.                 for hard copy output devices)
  169.    -p       use parallel rather than perspective projection (faster, 
  170.            but one less depth cue)
  171.    -s       (with no argument) scale data to fill a cube
  172.    -s  num      (with one argument) enlarge the display by a factor num.
  173.            The -s switch may be included twice, once with an argument
  174.            and once without, if both effects are wanted.
  175.    -t       draw line from each data point to the XY plane
  176.    -x  NUM1 NUM2  let x axis extend from NUM1 to NUM2
  177.    -y  NUM1 NUM2  let y axis extend from NUM1 to NUM2
  178.    -z  NUM1 NUM2  let z axis extend from NUM1 to NUM2
  179.  
  180. DEVICE DRIVER CONFIGURATION FILES
  181.  
  182.     The hard copy versions (DOTSHI, DOTSHP, DOTSLI, DOTSPS) can also
  183.     accept parameters from an ASCII configuration file.  Entries in
  184.     the file are switches, some with arguments, as on a command line. 
  185.     The following switches are available:
  186.  
  187.     -p        portrait orientation (LI and PS only)
  188.     -l        landscape orientation (the default) (LI and PS only)
  189.     -o <xoffset> <yoffset>
  190.     -r <xoffset>
  191.     -d <yoffset>
  192.             offset in inches from top left corner of page
  193.     -s <width> <height>
  194.     -w <width>
  195.     -h <height>
  196.             plot size in inches 
  197.     -f <name>    name of output file (or port)
  198.     -v <velocity>    pen velocity (HP and HI versions only).
  199.             Units are cm/sec for HP and in/sec for HI.
  200.     -n <name>    Plotter name (HI version only).  Choices
  201.             are "DMP-29" (the default) and "DMP-7".  Case is not
  202.             distinct, and "29" and "7" are also accepted.
  203.  
  204.     None of the arguments can be omitted.  A semicolon introduces a
  205.     comment that extends to the end of the line.
  206.  
  207.     A switch may start with '+' instead of '-', in which case it will
  208.     establish the default, but the program will still ask for the
  209.     final value.
  210.  
  211.     The PostScript device driver configuration file name will be, in
  212.     decreasing order of priority:
  213.  
  214.         1. An "&filename" entry on the command line
  215.         2. GRAPHPS.CFG in the current directory.
  216.  
  217.     The Houstin Instruments version would look for a configuration
  218.     file named GRAPHHI.CFG, etc.  If more than one &filename entry
  219.     appears, only the last configuration file referenced is read.
  220.  
  221.     A PostScript output file name will be, in decreasing order of
  222.     priority:
  223.  
  224.         1. The argument of the -f switch in the device
  225.             driver configuration file,
  226.         2. The value of the environment variable PLOT_PORT, or
  227.         3. FOO.PS, where FOO is the root name of the first
  228.             data file.
  229.  
  230.     Output file names for the other versions are generated similarly, but
  231.     with extensions .HI, .HP, or .LI.
  232.  
  233. REVISION HISTORY
  234.     8 Oct 90    1.51: Extra new_frame removed, so PostScript
  235.             output works.  '+' and '-' also change amount
  236.             of enlargement or shrinking.  Hitting any key
  237.             interrupts the current display.
  238.     4 Aug 90    1.50: Help display is now properly centered.
  239.             Final viewpoint is printed when program finishes. 
  240.             pgup and pgdn move observer in and out, home
  241.             and end scale the display.  Hard copy versions
  242.             accept configuration files, and no longer require
  243.             the user to type 'Q'.
  244.  
  245. BUGS
  246.     Axis labels would help.  Most of the options for the Unix utility
  247.     GRAPH would help.  
  248.  
  249. AUTHOR
  250.     Copyright (c) 1985-1989 by James R.  Van Zandt (jrv@mitre-bedford)
  251.     27 Spencer Dr., Nashua NH 03062, 603-888-2272.  Resale forbidden,
  252.     copying for personal use encouraged.  Constructive comments
  253.     welcome.  
  254.  
  255.